home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / OpenGL / glinterleavedarrays.z / glinterleavedarrays
Encoding:
Text File  |  2001-04-17  |  7.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ggggllllIIIInnnntttteeeerrrrlllleeeeaaaavvvveeeeddddAAAArrrrrrrraaaayyyyssss((((3333GGGG))))        OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee        ggggllllIIIInnnntttteeeerrrrlllleeeeaaaavvvveeeeddddAAAArrrrrrrraaaayyyyssss((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllIIIInnnntttteeeerrrrlllleeeeaaaavvvveeeeddddAAAArrrrrrrraaaayyyyssss - simultaneously specify and enable several
  10.      interleaved arrays
  11.  
  12.  
  13. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  14.      void ggggllllIIIInnnntttteeeerrrrlllleeeeaaaavvvveeeeddddAAAArrrrrrrraaaayyyyssss( GLenum _f_o_r_m_a_t,
  15.                                GLsizei _s_t_r_i_d_e,
  16.                                const GLvoid *_p_o_i_n_t_e_r )
  17.  
  18.  
  19. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  20.      _f_o_r_m_a_t   Specifies the type of array to enable. Symbolic constants
  21.               GGGGLLLL____VVVV2222FFFF, GGGGLLLL____VVVV3333FFFF, GGGGLLLL____CCCC4444UUUUBBBB____VVVV2222FFFF, GGGGLLLL____CCCC4444UUUUBBBB____VVVV3333FFFF, GGGGLLLL____CCCC3333FFFF____VVVV3333FFFF,
  22.               GGGGLLLL____NNNN3333FFFF____VVVV3333FFFF, GGGGLLLL____CCCC4444FFFF____NNNN3333FFFF____VVVV3333FFFF, GGGGLLLL____TTTT2222FFFF____VVVV3333FFFF, GGGGLLLL____TTTT4444FFFF____VVVV4444FFFF,
  23.               GGGGLLLL____TTTT2222FFFF____CCCC4444UUUUBBBB____VVVV3333FFFF, GGGGLLLL____TTTT2222FFFF____CCCC3333FFFF____VVVV3333FFFF, GGGGLLLL____TTTT2222FFFF____NNNN3333FFFF____VVVV3333FFFF,
  24.               GGGGLLLL____TTTT2222FFFF____CCCC4444FFFF____NNNN3333FFFF____VVVV3333FFFF, and GGGGLLLL____TTTT4444FFFF____CCCC4444FFFF____NNNN3333FFFF____VVVV4444FFFF are accepted.
  25.  
  26.      _s_t_r_i_d_e   Specifies the offset in bytes between each aggregate array
  27.               element.
  28.  
  29. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  30.      ggggllllIIIInnnntttteeeerrrrlllleeeeaaaavvvveeeeddddAAAArrrrrrrraaaayyyyssss lets you specify and enable individual color, normal,
  31.      texture and vertex arrays whose elements are part of a larger aggregate
  32.      array element.  For some implementations, this is more efficient than
  33.      specifying the arrays separately.
  34.  
  35.      If _s_t_r_i_d_e is 0, the aggregate elements are stored consecutively.
  36.      Otherwise, _s_t_r_i_d_e bytes occur between the beginning of one aggregate
  37.      array element and the beginning of the next aggregate array element.
  38.  
  39.      _f_o_r_m_a_t serves as a ``key'' describing the extraction of individual arrays
  40.      from the aggregate array.  If _f_o_r_m_a_t contains a T, then texture
  41.      coordinates are extracted from the interleaved array.  If C is present,
  42.      color values are extracted. If N is present, normal coordinates are
  43.      extracted.  Vertex coordinates are always extracted.
  44.  
  45.      The digits 2, 3, and 4 denote how many values are extracted.  F indicates
  46.      that values are extracted as floating-point values.  Colors may also be
  47.      extracted as 4 unsigned bytes if 4UB follows the C.  If a color is
  48.      extracted as 4 unsigned bytes, the vertex array element which follows is
  49.      located at the first possible floating-point aligned address.
  50.  
  51. NNNNOOOOTTTTEEEESSSS
  52.      ggggllllIIIInnnntttteeeerrrrlllleeeeaaaavvvveeeeddddAAAArrrrrrrraaaayyyyssss is available only if the GL version is 1.1 or
  53.      greater.
  54.  
  55.      If ggggllllIIIInnnntttteeeerrrrlllleeeeaaaavvvveeeeddddAAAArrrrrrrraaaayyyyssss is called while compiling a display list, it is
  56.      not compiled into the list, and it is executed immediately.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllIIIInnnntttteeeerrrrlllleeeeaaaavvvveeeeddddAAAArrrrrrrraaaayyyyssss((((3333GGGG))))        OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee        ggggllllIIIInnnntttteeeerrrrlllleeeeaaaavvvveeeeddddAAAArrrrrrrraaaayyyyssss((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      Execution of ggggllllIIIInnnntttteeeerrrrlllleeeeaaaavvvveeeeddddAAAArrrrrrrraaaayyyyssss is not allowed between the execution of
  75.      ggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of ggggllllEEEEnnnndddd, but an error may or may
  76.      not be generated. If no error is generated, the operation is undefined.
  77.  
  78.      ggggllllIIIInnnntttteeeerrrrlllleeeeaaaavvvveeeeddddAAAArrrrrrrraaaayyyyssss is typically implemented on the client side.
  79.  
  80.      Vertex array parameters are client-side state and are therefore not saved
  81.      or restored by ggggllllPPPPuuuusssshhhhAAAAttttttttrrrriiiibbbb and ggggllllPPPPooooppppAAAAttttttttrrrriiiibbbb.  Use ggggllllPPPPuuuusssshhhhCCCClllliiiieeeennnnttttAAAAttttttttrrrriiiibbbb and
  82.      ggggllllPPPPooooppppCCCClllliiiieeeennnnttttAAAAttttttttrrrriiiibbbb instead.
  83.  
  84. EEEERRRRRRRROOOORRRRSSSS
  85.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _f_o_r_m_a_t is not an accepted value.
  86.  
  87.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _s_t_r_i_d_e is negative.
  88.  
  89.  
  90. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  91.      ggggllllAAAArrrrrrrraaaayyyyEEEElllleeeemmmmeeeennnntttt, ggggllllCCCCoooolllloooorrrrPPPPooooiiiinnnntttteeeerrrr, ggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss, ggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss,
  92.      ggggllllEEEEddddggggeeeeFFFFllllaaaaggggPPPPooooiiiinnnntttteeeerrrr, ggggllllEEEEnnnnaaaabbbblllleeeeCCCClllliiiieeeennnnttttSSSSttttaaaatttteeee, ggggllllGGGGeeeettttPPPPooooiiiinnnntttteeeerrrr, ggggllllIIIInnnnddddeeeexxxxPPPPooooiiiinnnntttteeeerrrr,
  93.      ggggllllNNNNoooorrrrmmmmaaaallllPPPPooooiiiinnnntttteeeerrrr, ggggllllTTTTeeeexxxxCCCCoooooooorrrrddddPPPPooooiiiinnnntttteeeerrrr, ggggllllVVVVeeeerrrrtttteeeexxxxPPPPooooiiiinnnntttteeeerrrr
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.